Carbon


PlayThemeSound

Header: Appearance.h Carbon status: Supported

Plays an asynchronous sound associated with the specified state change.

OSStatus PlayThemeSound (
    ThemeSoundKind kind
);
kind

A value of type ThemeSoundKind. Pass a constant specifying the sound to play; see “Theme Sound Constants” for descriptions of possible values.

function result

A result code.

DISCUSSION

The Appearance Manager automatically plays theme sounds for standard user interface elements. Your application can call the PlayThemeSound function to play a theme sound for a custom element. The sound plays asynchronously until complete, stopping automatically.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)